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PREFACE 


This  report  is  published  to  provide  coastal  engineers  with  the  documenta¬ 
tion  of  a  package  of  computer  programs  for  editing,  analyzing,  and  displaying 
beach  profile  survey  data.  This  package,  named  the  Beach  Profile  Analysis 
System  (BPAS),  was  needed  for  the  analysis  of  a  large  data  bank  of  field  and 
laboratory  profile  surveys.  The  work  was  carried  out  under  the  U.S.  Army 
Coastal  Engineering  Research  Center's  (CERC)  Beach  Profile  Studies  work  unit, 
Shore  Protection  and  Restoration  Program,  Coastal  Engineering  Area  of  Civil 
Works  Research  and  Development. 

This  report  (Vol.  IV),  the  fourth  of  eight  volumes,  contains  user  instruc¬ 
tions  for  the  analysis  module  SURVY2,  which  produces  plots  and  tables  of 
contour  positions. 

The  report  was  prepared  by  Marilyn  V.  Fleming  and  Timothy  J.  Lawler, 
Systems  Analysts,  under  the  supervision  of  P.  Pierce,  Chief,  ADP  Office, 
with  the  assistance  of  Allan  E.  DeWall,  Geologist,  under  the  supervision  of 
C.J.  Galvin,  former  Chief,  Coastal  Processes  Branch,  and  Mr.  R.P.  Savage, 
Chief,  Research  Division. 

Instrumental  insight  concerning  a  previous  version  of  the  Beach  Profile 
Analysis  System  was  provided  by  B.  Sims.  Programing  was  accomplished  by 
M.  Fleming  and  T.  Lawler  with  the  assistance  of  D.  French,  J.  Alquist, 
R.  Hylton,  and  F.  Wilson. 

The  authors  acknowledge  the  helpful  discussions  and  review  comments  of 
Drs.  C.  Everts,  C.  Galvin,  R.  Hallermeier,  and  C.  Vincent,  and  W.  Birkemeler, 
M.  Hems ley,  A.  DeWall,  H.C.  Miller,  B.  Sims,  and  P.  Vitale. 

Technical  Director  of  CERC  was  Dr.  Robert  W.  Whalin,  P.E.,  upon  publica¬ 
tion  of  this  report. 

Comments  on  this  publication  are  invited. 


Approved  for  publication  In  accordance  with  Public  Law  166,  79th  Congress, 
approved  31  July  1945,  as  supplemented  by  Public  Law  172,  88th  Congress, 
approved  7  November  1963. 
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CONVERSION  FACTORS,  U.S.  CUSTOMARY  TO  METRIC  (SI)  UNITS  OF  MEASUREMENT 

U.S.  customary  units  of  measurement  used  In  this  report  can  be  converted  to 
metric  (SI)  units  as  follows: 


Multiply 

by 

To  obtain 

Inches 

25.4 

millimeters 

2.54 

centimeters 

square  inches 

6.452 

square  centimeters 

cubic  inches 

16.39 

cubic  centimeters 

feet 

30.48 

centimeters 

0.3048 

meters 

square  feet 

0.0929 

square  meters 

cubic  feet 

0.0283 

cubic  meters 

yards 

0.9144 

meters 

square  yards 

0.836 

square  meters 

cubic  yards 

0.7646 

cubic  meters 

miles 

1.6093 

kilometers 

square  miles 

259.0 

hectares 

knots 

1.852 

kilometers  per  hour 

acres 

0.4047 

hectares 

foot-pounds 

1.3558 

newton  meters 

-■  i 

millibars 

1.0197  x  10“3 

kilograms  per  square  centimeter  \ 

ounces 

28.35 

grams 

pounds 

453.6 

grams 

0.4536 

kilograms 

ton,  long 

1.0160 

metric  tons 

ton,  short 

0.9072 

metric  tons 

4  ■ 

degrees  (angle) 

0.01745 

radians 

Fahrenheit  degrees 

5/9 

Celsius  degrees  or  Kelvins1 

*To  obtain  Celsius  (C)  temperature  readings  from  Fahrenheit  (F)  readings, 
use  formula:  C  ■  (5/9)  (F  -32). 

To  obtain  Kelvin  (K)  readings,  use  formula:  K  -  (5/9)  (F  -32)  +  273.15. 
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BEACH  PROFILE  ANALYSIS  SYSTEM  (BPAS) 

Volume  IV.  BPAS  User's  Guide:  Analysis  Module  SURVY2 


» 


\ 

\ 


by 

Marilyn  V.  Fleming  and  Timothy  J.  Loonier 


I.  INTRODUCTION 


This  report,  the  fourth  of  eight  volumes,  providee  user  instructions  for 
processing  analysis  module  SURVY2,  a  part  of  the  Beach  Profile  Analysis  System 
( BPAS  )J~(  Fig.  1).  -The  BPAS  is  a  package  of  computer  programs  which  edit  and 
analyze  beach  profile  data.  The  objective  of  the  analysis  is  to  compute  and 
display  changes  in  unit  volume,  shoreline  position,  and  profile  geometry. 
SURVY2  displays  beach  profile  changes,  through  time,  at  a  locality  by  pro¬ 
viding  plots  and  tables  of  the  changes  in  distance  to  selected  beach  contours. 
The  means  of  these  distances  through  time  at  a  locality  are  also  computed  and 
displayed,  along  with  linear  regression  analysis  of  the  change  in  shoreline 
position  through  time.  ^  "  - -  — . _ 


Volumes  I  and  VIII  contain  information  concerning  data  collection, 
formatting  and  restrictions,  and  program  computations,  assumptions,  and  error 
messages  not  repeated  in  this  volume.  It  is  recommended  that  Volumes  I  and 
VIII  be  used  in  conjunction  with  this  volume.  Volume  II,  which  is  a  user's 
guide  for  processing  the  editing  routines,  EDIT1  and  EDIT2,  contains  guide¬ 
lines  for  the  initial  preparation  of  survey  data.  These  guidelines  are  not 
repeated  in  this  volume.  Other  volumes  available  in  the  series  are: 


(a)  Volume  III,  "BPAS  User's  Guide:  Analysis  Module  SURVY1," 

which  produces  comparative  plots  of  beach  profiles. 

(b)  Volume  V,  “BPAS  User's  Guide:  Analysis  Module  BEACH,”  which 

produces  plots  and  tables  of  unit  volume  and  shoreline  position 

changes. 

(c)  Volume  VI,  "BPAS  User’s  Guide:  Analysis  Module  VOLCTR," 

which  produces  tables  and  plots  of  change  in  unit  volume  between 

specific  contour  segments. 

(d)  Volume  VII,  “BPAS  User's  Guide:  Analysis  Module  ELVDIS,” 

which  produces  tables  and  plots  of  change  and  maxlmun  and  minimum 

elevations  at  specific  distances. 


Each  of  these  volumes  contains  instructions  for  processing  only  the  module 
with  which  it  is  concerned. 


II.  PROGRAM  DESCRIPTION 

The  survey  input  data  processed  by  program  SURVY2  (Fig.  2)  are  assumed  to 
have  already  been  processed  through  the  editing  routines,  EDIT1  and  EDIT2. 
These  edit  routines  perform  a  thorough  edit  and  a  partial  analysis  of  the 
data.  The  result  of  this  preliminary  analysis  is  contained  on  the  first 
record  in  the  survey  data  input  file,  the  header  record.  The  information 
on  the  header  record,  along  with  information  specifying  desired  outputs  and 
optional  data  specifications,  is  used  to  determine  whether  the  data  will 
exceed  the  program  capabilities.  If  capabilities  will  be  exceeded  or  the  job 
has  been  Improperly  set  up,  SURVY2  will  print  an  appropriate  error  message  and 
stop  execution  after  this  initial  test.  Otherwise,  the  program  will  continue. 
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Figure  !•  Beach  Profile  Analysis  System. 
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SURVY2  reads  the  survey  input  data,  finds  the  position  of  selected  con¬ 
tours,  and  produces  the  requested  plot  or  table  outputs.  Records  are  read 
from  the  survey  input  data  file,  requested  adjustments  to  the  vertical  or 
horizontal  coordinates  are  made,  and  the  coordinates  are  converted  to  output 
units  of  measurement.  The  distance  to  the  shoreline  position  is  computed 
and  this  point  is  added  to  each  record  if  it  is  not  a  surveyed  coordinate. 
Once  all  data  for  a  single  profile  line  have  been  read,  the  distance  to  the 
selected  contour  intercepts  and  the  temporal  mean  of  the  contour  position  are 
computed.  The  weighting  factor  for  the  spatial  mean  (Sec.  VI, 4, p)  is  found 
and  the  data  for  the  spatial  mean  accumulated.  Outputs  pertaining  to  each 
profile  line  are  produced  before  the  data  for  the  next  line  are  read.  Any 
profile  lines  for  which  output  cannot  be  produced  (e.g.,  those  for  which  the 
output  horizontal  datum  cannot  be  computed)  are  identified. 

Once  data  for  all  profile  lines  ha  Te  been  read  and  processed,  the  spatial 
means  are  computed  and  outputs  pertaining  to  all  profile  lines  are  produced. 
When  these  outputs  are  completed,  plot  statistics  (number  of  each  type  of  plot 
produced)  are  written. 

Hi.  HARDWARE  AND  SOFTWARE  REQUIREMENTS 

SURVY2  is  written  in  extended  FORTRAN  IV  and  was  designed  to  take 
advantage  of  processing  features  available  on  the  Control  Data  Corporation 
6600,  Cyber  176  or  equivalent  computer.  Such  features  include  the  10- 
character,  60-bit  word  size,  the  FORTRAN-callable  sort  routine  (interfacing 
with  the  NOS  or  NOS/BE  operating  system  SORTMRG  utility),  and  the  utility 
subroutines  and  functions  DATE,  TIME,  EOF  (to  check  for  end  of  data  file), 
FLOAT,  IFIX,  ABS,  MOD,  and  the  maximum  and  minimum  functions. 

General  processing  requirements  include  the  500  series  CALCOMP  plotting 
instructions,  block  data  subroutines,  ENCODE,  DECODE,  variable  dimensions  in 
subroutines,  132-position  line  printer,  a  plotter,  and  66,000  (decimal)  words 
of  core.  Also  required  are  the  capabilities  to  process  variable  length 
records  of  up  to  635  characters,  to  perform  unformatted  reads  and  writes,  to 
access  up  to  five  unique  units  for  input  and  output,  and  to  use  variable 
formats  and  variable  input  and  output  units  in  FORTRAN  READ  and  WRITE 
statements. 

A  single  run  producing  all  available  outputs  using  the  input  data  listed 
in  Appendix  G  of  Volume  VIII,  15  surveys  of  12  profile  lines,  required  an 
average  of  46,000  words  of  core  and  about  122  CPU  seconds  of  processing 
time.  There  were  about  50  pages  of  output  and  468  plots.  The  job  created 
about  31,000  plot  cards.  The  program  is  dimensioned  to  process  up  to  150 
surveys  of  100  profile  lines,  each  defined  with  up  to  60  coordinate  pairs. 
The  restrictions  on  number  of  surveys,  profile  lines,  and  coordinate  pairs  can 
be  changed;  however,  a  discussion  of  the  method  for  doing  so  is  outside  the 
scope  of  this  report.  There  may  be  no  more  than  12  contours  specified  for 
analysis  during  a  single  run. 


IV.  INPUT  DATA 

The  input  data  consist  of  survey  records  which  have  been  carefully  edited 
and  properly  formatted  by  the  EDIT1  and  EDIT2  programs  (see  Vol.  II).  The 
first  record  in  the  survey  data  file,  the  header  record  (Table  1),  supplies 
the  range  of  profile  line  numbers,  survey  numbers,  and  dates.  It  specifies  in 
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Table  1.  Format  of  the  header  record. 


Position  No. 

Entry  description 

FORTRAN  format 

1-2 

00 

A2 

3-5 

Lowest  profile  line  number  in  data  file 

13 

6-9 

Lowest  survey  identification  number  in  data 
file 

14 

10-12 

Highest  profile  line  number  in  data  file 

13 

13-16 

Highest  survey  identification  number  in  data 
file 

14 

17-19 

Maximum  number  coordinate  pairs  required  to 
define  any  one  survey 

13 

20 

Number  of  places  to  the  right  of  the  decimal 
for  distance  coordinates 

11 

21 

Number  of  places  to  the  right  of  the  decimal 
for  elevation  coordinates 

11 

22-23 

Two-character  abbreviation  for  units  of 
measurement  in  which  data  are  recorded 

A2 

24-27 

Four-character  acronym  describing  the 
vertical  datum  to  which  data  are  referenced 

A4 

28-49 

Range  of  dates,  including  time,  covered 
by  data  (yr(I2),  mon(I2),  d(I2),  hr(I3), 
min(I2)) 

2(312,13,12) 

50-80 

Data  description  (31  characters) 

31A1 

what  units  of  measurement  the  data  are  recorded,  where  the  decimal  should  be 
In  the  distance  and  elevation  coordinates,  and  to  what  vertical  datum  the  data 
are  recorded.  This  record  also  contains  a  31-character  data  description. 
This  information  is  as  supplied  to  or  computed  by  the  EDIT2  program.  If  the 
information  on  the  header  record  indicates  that  the  data  will  exceed  any  of 
the  program  dimensions,  an  error  message  is  printed  and  program  execution  is 
stopped. 

The  survey  data  file,  from  magnetic  media  (Table  2)  or  card  images  (Table 
3),  must  be  sorted  by  profile  line  number  and  then  survey  number.  The  module 
ignores  locality  codes  so  all  data  on  a  single  file  should  be  from  the  same 
locality. 


V.  MODULE  OUTPUTS 

SURVY2  will  produce  six  tabular  and  two  graphical  displays,  referred  to  as 
TABLE2,  TABLE3,  TABLE4 ,  TABLE5 ,  TABLE6 ,  TABLE7 ,  PL0T4 ,  and  PL0T5 .  Any  or  all 
of  these  may  be  produced  during  a  single  run.  In  addition,  tables  of  selected 
options  and  specifications  are  produced  by  each  run  of  each  analysis  module. 
These  tables  may  be  produced  and  examined  before  survey  data  are  processed 
(see  Sec.  Vl,l).  The  plot  statistics  are  produced  by  the  analysis  modules 
when  plot  output  has  been  requested.  A  footnote  or  plot  legend,  ”X  EXTRAPO¬ 
LATED  DATUM,”  will  appear  only  if  the  user  has  elected  to  allow  extrapolation 
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Table  2.  Format  of  final  data  file,  recorded  on  magnetic  media. 


Position  No. 

Entry  description 

FORTRAN  format 

1-2 

Locality  code 

A2 

3-5 

Profile  line  number 

13 

6-9 

Survey  identification  number 

14 

10-15 

Date  of  survey 

312 

16-20 

Time  of  survey 

13,12 

21-23 

Number  of  coordinate  pairs  in  the 

record 

13 

24-28 

Minimum  elevation  on  the  record 

15 

29-35 

Blank 

7X 

36-end 

Distance  and  elevation  coordinate 
five  positions  per  coordinate,  no 

pairs, 

decimal 

15 

Table 

3.  Format  of  final  data  file — card  image 

data. 

Position 

No. 

Entry  description 

FORTRAN  format 

First  card  in  each  record 

1-2 

Locality  code 

A2 

3-5 

Profile  line  number 

13 

6-9 

Survey  identification  number 

14 

10 

Card  number  (1) 

A1 

11-16 

Date  of  survey 

312 

17-21 

Time  of  survey 

13,12 

22-24 

Number  of  coordinate  pairs  in  the  record 

13 

25-29 

Minimum  elevation  this  record 

15 

30-40 

Blank 

41-80 

First  four  distance,  elevation  coordinate, 
five  columns  each  coordinate,  no  decimals1 

815 

Second  and  following  cards  in  each  record 

1-9 

Same  as  for  first  card 

10 

Card  number  (1-9,  then  A-Z) 

A1 

11-80 

Seven  distance,  elevation  coordinate  pairs 
five  positions  each  coordinate 

,  1415 

^Position  of  decimal  is  defined  on  the  header  record  (see  Table  5). 

NOTE. — If  there  are  exactly  four  coordinate  pairs  (first  card  only 
needed,  filled  to  position  80),  the  second  and  the  last  card  in  the 
record  must  be  a  blank  card. 
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of  the  shoreline  position  (see  Sec*  VI, 3, g).  The  position  of  every  contour 
computed  using  an  extrapolated  datum  is  identified  by  an  "X.” 

In  TABLE5,  TASLE6 ,  and  TABLE7,  mean  distances  for  which  a  contour  was 
not  defined  at  all  profile  lines  are  identified  with  an  The  number  of 

profile  lines  considered  in  the  computations  appears  in  table  headings*  The 
analysis  of  up  to  12  contours  may  be  performed  during  a  single  run  of  the 
module.  Unless  otherwise  specified,  all  table  and  plot  outputs  deal  with  the 
seawardmost  position  of  the  selected  contours. 

Whenever  a  contour  position,  change  in  position,  or  mean  position  cannot 
be  computed,  blanks  appear  in  table  outputs  and  a  dashline  connects  defined 
points  on  plot  outputs.  No  information  is  displayed  on  plot  outputs  before 
the  first  defined  position  is  found  or  after  the  last  one  has  been  plotted. 
If  a  contour  position  is  defined  during  only  one  survey,  the  contour  is  not 
represented  on  plot  outputs. 

Surveys  are  Identified  by  date.  If  desired,  the  time  of  the  survey  is 
also  written.  When  there  is  more  than  one  profile  line  involved,  the  date 
used  is  that  associated  with  the  profile  line  having  the  largest  line  number. 

Time-elapsed  is  the  Independent  variable  for  regression  analysis  and 
the  independent  axis  for  plot  outputs.  At  the  user's  option,  this  may  be 
expressed  in  hours,  days,  months,  or  years.  When  months  are  selected,  only  1 
year's  data  are  displayed  on  each  plot.  Enough  plots  will  be  output  to  depict 
all  data.  Sample  outputs  shown  in  the  following  figures  have  been  photo- 
reduced. 

1.  Table  of  Options  Selected  (Fig.  3). 

This  table,  produced  after  all  option  cards  have  been  read  by  the  program, 
prints  the  value  assigned  to  each  variable  which  can  be  defined  on  an  option 
card.  This  table  should  be  examined  to  ensure  that  the  values  assigned  to 
these  variables  are  as  anticipated. 

OMIMI  "•»  »WN  U/it/St  AT  U.ll.l*. 

tMlMII  N00ULI  illlCTIO*.  fURVOI  ........... 

umr  mtcT(0  run  mam 

LOCAL  IT!  OErCRIRTOR  II  TUT  ■•ACM 

CACH  lURTMrO  LIU  KILL  M  IALLIO  I  RRORILC 

INRuT  OIIIAnCU  ARC  CONRUTIO  IRON  TNI  RCNIHNARK 

INRuT  OIIIAnCU  TO  RT  I  »«•».».  ELEVATION!  10  RT  1  »•*••! 

VIATICAL  OAtUM  II  MIL 

A  CORRECTION  OR  1.900  RT  MILL  II  «A0C  TO  (ASM  VMTXCAL  COhOROINaTC, 

TIME  KILL  AkREAR  ON  OUTRUT,  ■••HOUR  ITITEN  RILL  ■•>  UIID, 

MORtlONTAL  BATON  II 
THE  ImORILInE  ROIITION  ON 
OCEERENCC  luRVIT 

THERE  arc  No  MORI  THAN  I  RRORIbl  LINCI, 

THi  initial  luivcy  or  each  rririli  line  mill  ai  thi  rcrerincc  iurvit, 

a  convcriion  cactor  or  i.oiiii  hill  at  nice  to  ao  mom  inrot  unite  crtj  to  outrut  uniti  crt> 

a  convcriion  ractor  or  ,oiti«  hjll  at  u»u  to  ao  room  oouart  rt  to  tiwtt 

CITRAROLAIIoN  kiln  01  00NC  TO  RSL  IR  THE  L|0T  OURVCRIO  R0INT  RlACNCI  A  MINIMUM  ELEVATION  OR  1.000  RT 

•URVIY  INRUt  data  HILL  II  Read  ROOM  unit  T  in  TN|I  RORNATh. 

(•<tIJiI*'llliJl*Ilt !)• TTiliTl i IIORf .0) 

Figure  3.  Sample  SURVY2  output-table  of  options  selected. 
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2.  Table  of  Specifications  Selected  (Fig.  4). 

This  cable  is  produced  after  all  special  processing  and  output  selection 
specifications  have  been  read  by  the  program.  Anticipated  processing  speci¬ 
fications  and  outputs  should  be  compared  with  those  actually  selected. 

3.  TABLE2  (Fig.  5). 

This  table  displays  the  distance  to  the  seawardmost  intercept  of  each  of 
the  selected  contour  intercepts  during  surveys  at  a  profile  line.  Optionally, 
the  distance  to  10  additional  landward  intercepts  will  be  written.  '  Also 
displayed  is  the  mean  position  of  each  contour  intercept  during  all  surveys  of 
the  line  and  the  percentage  of  surveys  during  which  the  contour  intercept  is 
defined.  The  table  will  optionally  display  results  of  least  squares  regres¬ 
sion  and  correlation  analysis  of  the  change  in  shoreline  position  (the  zero 
contour)  through  time.  There  will  be  one  table  output  for  each  profile 
line.  If  no  multiple  intercepts  are  to  be  displayed,  up  to  39  surveys  of  a 
line  will  be  written  on  each  page. 

4.  TABLE3  (Fig.  6). 

The  change  between  surveys  in  position  of  the  selected  contour  Intercepts 
at  each  profile  line  is  shown  on  this  table.  There  will  be  one  table  for  each 
profile  line  with  up  to  19  surveys  depicted  on  each  page. 

5.  TABLE4  (Fig.  7). 

This  table  shows  the  change  in  position  of  selected  contour  intercepts 
from  their  position  on  the  selected  reference  survey.  There  will  be  one  table 
for  each  profile  line  with  up  to  39  surveys  represented  on  each  page. 

6.  TABLE5  (Fig.  8). 

This  table  shows  the  spatial  means  of  the  selected  contour  positions 
during  each  survey  at  all  profile  lines.  Also  displayed  are  the  overall  mean 
positions  of  the  contours  (for  all  surveys  at  all  profile  lines)  and  the 
percentage  of  times  the  contour  intercept  is  defined.  There  is  only  one  table 
with  data  for  up  to  39  surveys  written  on  each  page. 

7.  TABLE6  (Fig.  9). 

This  table  depicts  the  change  in  the  average  position  of  selected  contour 
intercepts  from  one  survey  to  the  next.  The  average  used  is  the  spatial  mean 
of  the  contour  position  (from  TABLE5).  There  is  one  table  with  up  to  19 
surveys  shown  on  each  page. 

8.  TABLE7  (Fig.  10). 

This  table  shows  the  change  in  the  average  position  of  selected  contour 
Intercepts  from  the  averages  during  the  selected  reference  survey.  The 
average  positions  used  are  again  the  spatial  means  of  the  contour  positions 
(from  TABLE5).  There  is  one  table  and  up  to  39  surveys  written  on  each  page. 
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Figure  4.  Sample  SURVY2  output — table  of  specifications  and  outputs 
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Figure  6.  Sample  SURVY2  output — TABLES 
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Figure  9.  Sample  SURVY2  output — TABLE6 


9.  PL0T4  (Fig.  11) 


PL0T4  shows  the  distance  to  the  selected  contour  intercepts  during  surveys 
at  a  profile  line*  All  or  a  subset  of  the  selected  contours  can  be  plotted. 
The  user  controls  which  of  the  contours  are  to  be  plotted;  all  of  those 
selected  are  drawn  on  each  plot  (see  Fig.  11, a).  Optionally,  more  landward 
intercepts  of  contours  will  also  be  plotted.  The  more  landward  positions  are 
represented  in  a  scatter  format  with  each  contour  represented  by  a  different 
symbol.  There  will  be  at  least  one  plot  for  each  profile  line.  If  time  is  in 
months,  there  will  be  as  many  plots  per  profile  as  there  are  years  in  the  data 
file.  Figure  11(b)  is  specifically  designed  to  show  the  change  in  shoreline 
position. 

10.  PLOT 5  (Fig.  12). 

This  plot  shows  change  in  contour  position  at  one  or  more  profile  lines 
(Fig.  12, a).  Only  one  contour  is  represented  on  a  single  plot  but  several 
profile  lines  may  be  shown.  The  number  of  plots  produced  depends  on  the 
number  of  profiles  represented  on  each  and,  if  time  is  in  months,  the  number 
of  years  covered  by  the  data.  Figure  12(b)  is  specifically  designed  to  show 
change  in  shoreline  position. 

11.  PLOT  Statistics  (Fig.  13). 

At  the  end  of  each  run  for  which  PL0T4  or  PL0T5  output  was  requested, 
there  is  a  printed  table  of  the  number  of  sets  of  axes  drawn  for  each  type  of 
plot.  This  information  may  be  used  to  determine  how  many  plots  to  expect. 

VI.  JOB  STRUCTURE 

The  job  structure  for  each  of  the  analysis  modules  is  the  same  (Fig.  14). 
The  only  required  system  separators  are  those  following  the  system  job  control 
cards  and  signaling  the  end  of  the  job.  The  Appendix  contains  record  layouts 
for  each  of  the  option,  processing,  and  output  specification  cards  used  by 
module  SURVY2.  If  the  option  and  processing  specification  cards  are  absent, 
the  module  assigns  default  values.  The  output  specification  cards  are 
required  only  to  identify  which  outputs  are  desired;  there  is  a  default  set  of 
specifications  for  each  SURVY2  output.  The  format  and  defaults  for  the  output 
specification  cards  are  described  in  paragraph  5  of  this  section.  Note  that 
the  option  and  specification  cards  must  be  followed  by  a  blank  card  to  signal 
the  end  of  the  cards  to  be  read. 

The  following  contains  formats  for  the  records  needed  to  run  the  module. 
It  is  recommended  that  data  be  right- justified;  i.e.,  the  rightmost  character 
or  number  always  occupies  the  rightmost  position  in  the  field.  This  will 
ensure  that  extra  zeros  are  not  added  to  the  end  of  numeric  entries  when  they 
are  read  by  the  module. 

1.  Program  Identification  Cards. 

The  program  identification  card  (Table  4)  is  mandatory.  It  allows  the 
user  to  assign  a  name  to  each  run,  defines  which  analysis  module  is  to  be 
processed,  and  provides  the  option  to  halt  execution  after  the  table  of 
selected  options  and  processing  specifications  has  been  printed. 
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Figure  11.  Sample  SURVY2  output— PL0T4 . 
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CHANCE  IN  DISTANCE  TO  3.0  M  CONTOUR  POSITION  FOR 
2  PROFILE  LINES  AT  TEST  BEACH 

a.  Selected  contour  positions  plotted. 


CHANGE  IN  QISTANCE  TO  SHORELINE  FOR 
2  PROFILE  LINES  AT  TEST  BEACH 


b.  Shoreline  positions  plotted. 


Figure  '2.  Sample  SURVY2  output— PL0T5 . 


THIS  RUN  0INCR4TtD  THC  FQLLOWINB  ORARHIC  output, 

plot  ttpc  numbir  op  plots 


«  I 

1  1 

Figure  13.  Sample  SURVY2  output — table  of  plot  statistics. 
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(1)  Data  on  magnetic  media.  (Survey  data  file  not  read  from  same 
unit  as  options  and  specifications.) 


(2)  Data  on  cards  or  card  images.  (Survey  data  file  will  be 
read  from  the  same  unit  as  the  options  and  specifications.) 


Figure  14.  Job  structure. 
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Table  4.  Program  Identification  card. 


Position 

No. 

Entry  description 

Default 

value 

FORTRAN 

format 

1-6 

Run  identification,  usually  initials  of 
individual  submitting  job. 

None 

A6 

8-13 

Name  of  analysis  module  to  be  processed. 
This  entry  is  mandatory.  Enter  "SURVY2." 

None 

A6 

15-16 

Unit  from  which  survey  data  will  be  read. 
Enter  a  "5"  in  position  16  if  data  are 
to  be  read  from  cards  or  card  images. 

7  (magnetic 
media) 

12 

77-80 

Enter  ”N0G0"  to  halt  execution  after 
printing  of  options  and  specifications, 
otherwise  leave  blank. 

Run  will  be 
executed 

A4 

It  is  recommended  that  a  printout  of  selected  options  and  specifications, 
with  further  execution  suppressed,  be  the  first  run  for  each  analysis 
attempted.  To  do  this,  prepare  the  job  and  submit  it  with  NOGO  in  positions 
77  to  80  of  the  program  identification  card.  The  printed  options  (Fig.  3)  and 
specifications  (Fig.  4)  should  be  carefully  examined  to  be  sure  they  match 
those  requested.  When  satisfied  that  the  desired  options,  specifications,  and 
selected  outputs  are  correct,  resubmit  the  job  with  positions  77  to  80  blank. 


2.  The  Header  Record. 


The  header  record  (Table  1)  follows  the  program  identification  card  when 
data  are  read  from  cards  or  card  images.  If  survey  data  are  read  in  magnetic 
media  format,  the  header  record  is  not  a  part  of  the  deck  setup.  See  Section 
IV  if  more  information  concerning  the  header  record  is  desired. 


3.  The  Option  Cards. 

The  option  cards  make  it  possible  for  the  user  to  change  some  of  the  data 
characteristics,  processing  procedures,  and  output  specifications  assumed  by 
the  programs.  None  of  the  option  cards  are  required.  Table  5  contains  the 
option  cards  used  by  SURVY2  and  the  values  assigned  when  option  cards  are 
omitted.  If  any  of  the  values  are  to  be  changed,  only  the  option  cards  defin¬ 
ing  the  value  to  be  changed  need  be  submitted  and  only  the  fields  on  the  card 
pertaining  to  that  value  need  be  completed.  A  more  detailed  description  of 
each  option  card  follows. 


a.  Option  Card  1 — Input  Horizontal  Datum  (Table  6).  OPT  CRD  1  defines 
the  name  of  the  lines  surveyed  (e.g.,  profile,  range,  transect)  and  the  name 
of  the  input  horizontal  datum  (e.g.,  bench  mark,  base  line).  If  the  card  is 
omitted  or  the  pertinent  field  left  blank,  the  line  will  be  labeled  a  PROFILE 
line  and  the  input  horizontal  datum  will  be  called  the  BENCH  MARK. 
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Table  5.  SURVY2  analysis  options  and  their  defaults* 


Option  card 

Option 

Default  value 

OPT 

CRD 

1 

Name  of  input  horizontal  datum 

Bench  mark 

Name  of  line  surveyed 

Profile 

OPT 

CRD 

2 

Format  of  time  on  outputs 

No  time  appears 

OPT 

CRD 

3 

Abbreviation  for  new  vertical  datum 
and  required  vertical  correction 

Abbreviation  is  as  read 
from  header  record  and 
no  correction  is  made. 

OPT 

CRD 

4 

Output  horizontal  datum 

Shoreline  position 
during  first  survey  of 
each  profile  line 

Reference  for  change  in  contour 
position 

Contour  position  during 
first  survey  of  each 
profile  line 

OPT 

CRD 

7 

Description  of  the  data,  for  use  in 
titles 

As  read  from  the  header 
record 

OPT 

CRD 

8 

Linear  units  in  which  output  is  to 
appear 

As  read  from  the  header 
record 

Conversion  factor  to  change  input 
linear  units  to  output  linear  units 

1.0 

OPT 

CRD 

9 

Minimum  elevation  from  which  extra¬ 
polation  is  considered  valid  (>0) 

No  extrapolation  is 
performed 

OPT 

CRD 

10 

Format  in  which  the  final  data  file 
is  to  be  read 

As  necessary  to  read  data 
as  formatted  in  Table  3 
if  input  is  on  cards, 
otherwise  as  in  Table  2. 

Table  6.  Option  card  1 — Input  horizontal  datum. 


Position  No. 

Entry  description 

FORTRAN  format 

1-3 

"OPT" 

A3 

5-7 

”CRD" 

A3 

9 

»•  j  •• 

11 

11-17 

Enter  the  seven-character  name  of 
surveyed  line  if  other  than  PROFILE. 

A7 

19-28 

Enter  the 
horizontal 

10-character  name  of 
datum  if  other  than 

input 

BENCH  MARK. 

A10 
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b.  Option  Card  2 — Display  of  Time  (Table  7).  The  date  of  a  survey  always 
appears  on  outputs,  but  the  tine  of  the  survey  does  not.  OPT  CRD  2  allows  the 
user  to  define  the  type  of  time,  if  any,  which  is  to  appear  on  outputs.  If 
the  card  is  omitted  or  blank,  only  the  date  will  appear.  If  the  time  of  day 
(24-hour  clock)  or  the  time,  hours,  and  hundredths  option  is  selected,  both 
date  and  time  will  be  written  on  outputs.  If  the  latter  time  option  is 
selected,  the  minutes  will  be  converted  to  hundredths  of  an  hour  and  time 
displayed  as  a  decimal  number. 


Table  7.  Option  card  2 — display  of  time. 


Position  No. 

Entry 

description 

FORTRAN  format 

1-3 

"OPT" 

A3 

5-7 

"CRD" 

A3 

9 

"2" 

11 

11 

Enter  the  code  for  the  type  of  time 
to  be  written  on  printed  outputs: 

0  -  no  time  is  written 

1  -  24-hour  clock  time 

2  -  decimal  time 

11 

NOTE. — Date  of  survey  is  always  displayed  on  output. 


c.  Option  Card  3 — Output  Vertical  Datum  (Table  8).  OPT  CRD  3  allows  the 
user  to  change  the  vertical  datum  to  which  the  survey  data  are  referenced.  If 
the  card  is  omitted  or  left  blank,  the  vertical  datum  will  be  as  defined  on 
the  header  record  and  there  will  be  no  change  to  the  vertical  coordinates.  If 
a  change  is  desired,  enter  the  four-character  abbreviation  of  the  new  vertical 
datum  and  the  amount,  in  selected  output  unite,  which  must  be  added  to  each 
vertical  coordinate  to  make  the  adjustment. 


Table  8.  Option  card  3 — output  vertical  datum. 


Position  No. 

Entry  description 

FORTRAN  format 

1-3 

"OPT” 

A3 

5-7 

"CRD" 

A3 

9 

M  2  II 

11 

11-14 

Enter  the  four-character  abbrevia¬ 
tion  for  output  vertical  datum  if 
other  than  that  on  header  record. 

A4 

15-25 

Enter  the  amount,  in  output  units, 
to  be  added  to  each  vertical 
coordinate. 

F10.3 

d.  Option  Card  4 — Output  Horizontal  Datum  (Table  9).  OPT  CRD  4  allows 
the  user  to  select  the  reference  horizontal  datum  to  which  the  output  is  to 
be  adjusted.  If  this  card  is  omitted  or  left  blank,  the  shoreline  position 
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Table  9.  Option  card  4 — output  horizontal  datum. _ 

Position  No.  Entry  description _  FORTRAN  format 
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during  the  first  survey  of  each  profile  line  is  the  output  horizontal  datum. 
The  distance  to  the  shoreline  during  the  first  survey  at  each  profile  is 
computed  and  this  amount  is  subtracted  from  each  distance  coordinate.  The 
first  survey  also  supplies  the  reference  contour  position.  Other  choices  for 
the  output  horizontal  datum  are:  (1)  the  shoreline  position  during  a  survey 
other  than  the  first,  (2)  the  mean  shoreline  position,  (3)  the  input  hori¬ 
zontal  datum  (l.e.,  bench  mark — in  this  case  the  distance  coordinates  are 
unaltered),  and  (4)  a  user-supplied  correction.  If  the  reference  is  not  user- 
supplied,  use  the  OPT  CRD  4,  format  1,  shown  in  the  Appendix;  otherwise,  use 
OPT  CRD  4,  format  2. 

If  the  correction  is  supplied,  the  user  must  provide  SUP  4A  (Table  10) 
cards  to  define  the  amount,  in  output  units,  which  is  to  be  subtracted  from 
each  distance  coordinate  at  each  profile  line.  The  SUP  4A  cards  must  immedi¬ 
ately  follow  OPT  CRD  4,  be  sequentially  numbered,  and  cannot  be  Included  if 
the  output  horizontal  datum  adjustment  is  not  user-supplied.  While  there  need 
not  be  an  entry  on  the  SUP  4A  cards  for  every  profile  line  in  the  data  set, 
only  those  represented  will  be  processed  by  SURVY2. 


Table 

10. 

Supplementary  option  cards  4A — distance 
horizontal  datum,  user-supplied. 

to  output 

Position 

No. 

Entry  description  FORTRAN  format 

1-3 

"SUP" 

A3 

5-6 

”  4A" 

A2 

7-9 

Sequential  card  number 

13 

11-13 

Profile  line  number 

13 

14-23 

Corresponding  adjustment  in  output 
units,  to  be  subtracted  from 
each  distance  coordinate. 

F10.3 

24-26 

Profile  line  number 

13 

27-36 

Corresponding  adjustment 

F10.3 

37-39 

Profile  line  number 

13 

40-49 

Corresponding  adjustment 

F10.3 

50-52 

Profile  line  number 

13 

53-62 

Corresponding  adjustment 

F10.3 

63-65 

Profile  line  number 

13 

66-75 

Corresponding  adjustment 

F10.3 

When  the  output  horizontal  datum  is  the  mean  shoreline  position,  the  input 
horizontal  datum,  or  some  user-supplied  datum,  the  reference  for  change  in 
selected  contour  position  will  be  the  position  during  the  first  survey  of  each 
profile  line.  If  another  survey  is  to  supply  the  reference  position,  it  may 
be  specified.  When  the  output  horizontal  datum  is  a  selected  reference 
survey,  the  same  reference  survey  will  be  used  for  change  in  contour  posi¬ 
tion.  This  cannot  be  changed. 
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The  output  horizontal  datum  option  has  proven  to  be  useful  for  plotting 
profiles  with  horizontal  datums  well  inland  of  the  active  beach,  or  for 
comparing  lines  with  datums  at  varying  distances  from  the  shoreline.  By 
adjusting  the  horizontal  datum,  profiles  are  effectively  "lined  up"  at  the 
shoreline,  dune  crest,  or  other  selected  reference  distance.  Care  must  be 
taken  to  ensure  that  the  horizontal  datum  exists  on  the  reference  survey  of 
each  profile  line.  For  example,  under  default  conditions,  the  reference 
survey  is  the  first  survey  of  each  profile  line  and  the  horizontal  datum  is 
the  distance  to  the  zero  elevation  at  the  time  of  that  survey.  If  this 
position  is  not  defined  (i.e.,  the  survey  did  not  extend  far  enough  seaward), 
the  profile  line  is  eliminated  from  the  data  set  and  any  output  from  that 
particular  line  is  suppressed. 

Care  must  also  be  taken  to  ensure  that  subsequent  runs  of  the  data  file 
have  the  same  reference.  When  data  are  extracted  from  larger  sets  or  new  data 
are  added  to  existing  sets,  it  is  possible  that  the  first  survey  of  a  line 
will  change;  it  is  certain  that  the  mean  shoreline  position  will  change. 
Under  these  circumstances,  the  user  should  record  the  distance  to  the  hori¬ 
zontal  datum  for  the  original  data  set  and  supply  it  on  SUP  4A  card  during 
subsequent  runs. 

e.  Option  Card  7 — Data  Description  (Table  11).  The  description  of  the 
data  (e.g. ,  locality  or  site  name)  contained  on  the  header  record  will  appear 
on  each  output.  If  the  user  wishes  to  change  this  description,  OPT  CRD  7  may 
be  used.  If  the  card  is  omitted  or  left  blank,  the  data  description  will  be 
as  defined  on  the  header  record. 


Table  11.  Option  card  7 — data  description. 


Position 

No. 

Entry  description 

FORTRAN  format 

1-3 

"OPT” 

A3 

5-7 

"CRD" 

A3 

9 

•i  y  »• 

11 

11-41 

Enter  the  31-character  data 
description  which  supersedes  the 
description  on  the  header  record. 

3A10.A1 

Option 

Card 

8 — Linear  Output  Units  (Table  12). 

OPT  CRD  8  is  used 

define  the  linear  output  units.  If  the  card  is  omitted  or  left  blank,  the 
linear  output  units  will  be  the  same  as  the  input.  If  output  units  are  to 
be  meters  or  centimeters  and  the  input  is  in  feet,  the  conversion  factor  is 
supplied  by  the  program;  otherwise,  the  user  must  supply  the  required  con¬ 
version  factor.  Each  distance  and  elevation  read  from  the  input  survey  file 
will  be  multiplied  by  this  factor. 

g.  Option  Card  9— Extrapolation  to  Zero  Elevation  (Table  13).  Since  the 
shoreline  position  is  of  major  interest  in  the  analysis  of  beach  profile  data, 
there  may  be  cases  when  the  user  decides  that  extrapolating  the  distance  to 
the  zero  elevation  is  valid.  In  this  case,  OPT  CRD  9  can  be  used  to  specify 
the  elevation,  in  output  units  relative  to  the  output  vertical  datum,  that  the 
last  surveyed  point  must  reach  before  the  shoreline  position  can  be  extrapo¬ 
lated.  If  the  card  is  omitted  or  left  blank,  no  extrapolation  occurs.  When 
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Table  12.  Option  card  8 — linear  output  units. 


Position  No. 

Entry  description 

FORTRAN  format 

1-3 

"OPT" 

A3 

5-9 

"CRD" 

A3 

9 

"8" 

11 

11-12 

Enter  the  abbreviation  for  linear  output 
units  of  measurement.  If  blank,  these 
will  be  as  defined  on  the  header  record. 

A 2 

13-22 

Enter  the  conversion  factor.  Input  units 
are  multiplied  by  this  number  to  convert  to 
output  units.  This  field  may  be  blank  if: 

(a)  Input  and  output  units  are  the 
same  (factor  set  to  1). 

(b)  Input  units  are  FT,  output  units 
are  M  (factor  set  to  0.3048). 

(c)  Input  units  are  FT,  output  units 
are  CM  (factor  set  to  30.48). 

F10.3 

Table  13. 

Option  card  9 — extrapolation  to 

zero  elevation. 

Position 

No. 

Entry  description 

FORTRAN  format 

1-3 

"OPT” 

A3 

5-7 

"CRD" 

A3 

9 

••  gi* 

11 

11-20  Enter  the  maximum  elevation  above  the  out-  F10.3 

put  vertical  datum,  in  output  units,  which 
the  last  surveyed  point  must  reach  In  order 
that  the  shoreline  position  (datum  intercept) 
be  extrapolated.  If  this  is  blank  or  zero,  the 
_  shoreline  position  will  not  be  extrapolated. _ 


any  computation  is  performed  using  data  for  which  the  shoreline  position 
was  extrapolated,  output  of  the  results  of  that  computation  is  flagged.  No 

extrapolation  will  be  performed  for  profiles  where  the  last  line  segment  is 
not  sloping  seaward. 

h.  Option  Card  10 — Format  of  Input  Data  (Table  14).  If  the  format 
specified  for  card  image  data  (Table  3)  or  magnetic  media  data  (Table  2)  does 
not  fit  the  format  of  the  user's  input  data,  an  alternate  format  may  be 
specified  using  OPT  CRD  10.  Knowledge  of  FORTRAN  format  specifications  is 

required  to  use  this  option  effectively.  All  the  data  elements  but  the 

locality  code  are  used  in  the  analysis  computations.  Thus,  while  this  card 
can  be  used  to  change  the  field  length,  order,  or  format  in  which  data 

elements  are  read,  all  elements  must  be  present.  The  expected  order  of  the 
variables  is  shown  in  Tables  2  and  3;  the  order  in  which  the  variables  are 
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Table  14.  Option  card  10 — format  of  Input  data. 


Position  No. 

Entry  description 

FORTRAN  format 

1-3 

“OPT” 

A3 

5-7 

“CRD" 

A3 

8-9 

”10” 

12 

11-80 

Enter 

blank 

the  survey  data  format.  If  this  card  is 
or  omitted,  data  will  read  as  follows: 

7A10 

(a) 

Input  unit  is  5  (2X,I3,I4,1X,3I2, 
I3,I2,F5.0,11X,8F5.0/(10X,13F5.0)). 

(b) 

Input  unit  is  7  (2X, 13, 14,312,13, 
I2,I3,F5.0,7X,120F5.0). 

read  may  be  changed  by  using  the  FORTRAN  tab  or  T  format  specification.  The  T 
format  specification  Is  described  In  most  FORTRAN  texts  and  reference  manuals, 
e.g.,  Stuart  (1970)1. 

4.  Processing  Specification  Cards. 

These  cards  are  used  to  define  special  physical  characteristics  or  proc¬ 
essing  requirements  of  the  data.  When  they  are  omitted,  the  program  assumes 
that  the  data  conform  to  certain  specifications  and  assigns  default  values 
based  on  these  assumptions.  Table  IS  shows  the  processing  specifications 
available  for  the  processing  of  program  SURVY2  and  the  default  values  assigned 
to  them.  When  processing  specification  cards  used  for  other  analysis  modules 
are  included  in  the  SURVY2  setup,  they  are  ignored  and  there  is  no  effect  on 
processing.  A  more  detailed  description  of  each  specification  follows. 


Table  15.  SURVY2  processing  specifications  and  their  defaults. 


Specification 

Description 

Contour 

Default  value 

No.  Contour  elevation 

CONTOUR 

Selects  contours  for 

1 

-2.0 

analysis  and  assigns 

2 

-1.0 

a  sequential  number 

3 

0.0 

and  an  elevation  to 

4 

1.0 

each  contour  selected. 

5 

2.0 

6 

3.0 

7 

4.0 

8 

5.0 

9 

6.0 

10 

8.0 

11 

10.0 

12 

12.0 

DISTNCE 

Defines  distances 

Profile 

lines  are  assumed  to 

between  physically 

be  equidistant. 

adjacent  profile 
lines  for  weighting 
spatial  means  (in 
output  units). 

Stuart,  F.,  FORTRAN  Programming,  John  Wiley  &  Sons,  Inc.,  1970. 
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a.  CONTOUR  Specification  (Table  lb).  This  specification  allows  the  user 
to  select  the  contours  to  be  analyzed  if  they  differ  front  the  default.  There 
may  be  no  more  than  12  contours  selected  and  no  more  than  two  CONTOUR  cards. 
If  seven  or  fewer  contours  are  selected,  there  may  be  no  more  than  one  CONTOUR 
card.  Each  contour  is  assigned  a  sequential  number  when  it  is  entered.  Ail 
the  contours  defined  on  these  cards  will  appear  on  requested  table  outputs; 
however,  the  user  may  select  specific  contours  to  appear  on  plot  outputs.  The 
elevations  should  be  entered  in  output  units  of  measurement  relative  to  the 
output  vertical  datum. 


Table  16.  Format  of  CONTOUR  specification  card. 


Position  No. 

Entry  description 

FORTRAN  format 

1-7 

"CONTOUR" 

A7 

9 

Sequential  card  number 

11 

11-12 

Number  of  contours  to  process1 
(card  1  only) 

12 

15-21 

Contour  elevation,  expressed 
as  output  units  above  the 
output  vertical  datum 

F7.2 

24-30 

Contour  elevation 

F7.2 

33-39 

Contour  elevation 

F7.2 

42-48 

Contour  elevation 

F7.2 

51-57 

Contour  elevation 

F7.2 

60-66 

Contour  elevation  (card  1  only) 

F7.2 

69-75 

Contour  elevation  (card  1  only) 

F7.2 

1  If  this  card  is  used,  this  field  must  be  completed. 


b.  DISTNCE  Specification  (Table  17).  Volume  VIII,  Appendix  B,  explains 
the  method  used  to  weight  the  contours  when  the  spatial  mean  of  their  position 
Is  computed.  Essentially,  the  distance  between  adjacent  profile  lines  is  used 
to  determine  how  much  weight  is  given  to  values  computed  at  each  line.  The 
greater  the  space  between  profile  lines,  the  more  weight  is  given  to  values 
computed  at  the  line.  The  DISTNCE  specification  card  is  used  to  define  dis¬ 
tances  between  profile  lines  for  weighting.  Note  that  the  order  in  which 
profile  lines  are  entered  on  these  cards  must  correspond  to  the  physical  posi¬ 
tion  of  the  lines  (e.g.,  if  profile  line  33  is  between  profile  lines  4  and  5, 
data  must  be  entered  for  4,  33,  and  5,  respectively ) .  There  are  two  weights 
given  to  values  computed  at  each  line — one  is  half  the  distance  to  the  profile 
line  on  the  left  and  the  other  is  half  the  distance  to  the  line  on  the  right. 
Since  profile  lines  at  either  end  of  the  study  site  are  adjacent  to  only  one 
profile,  the  user  has  to  determine  the  Becond  weight  to  be  associated  with 
these  lines.  This  value  is  not  halved;  the  user  should  determine  how  far,  in 
the  direction  opposite  the  adjacent  profile  line,  values  computed  at  the  end 
lines  can  be  considered  valid.  There  will  be  one  more  distance  entered  than 
there  are  profile  lines.  Distances  should  be  entered  in  output  units  of 
measurement.  Profile  lines  are  assumed  to  be  parallel.  When  no  DISTNCE 
specification  is  supplied,  the  profile  lines  are  assumed  to  be  equidistant  and 
the  computed  mean  contour  position  is  a  simple  mean.  There  should  be  as  many 
DISTNCE  cards  as  needed  to  define  the  characteristics  for  the  number  of  pro¬ 
files  specified  on  the  first  card.  Supplying  more  or  less  cards  will  result 
in  an  error. 


34 


Table  17.  DISTNCE  specification  card — distance  between 
profile  lines  to  be  used  in  weighting. _ 


Position  No. 

Entry  description 

FORTRAN  format 

1-7 

"DISTNCE" 

A7 

8-9 

Sequential  card  number 

12 

11-13 

Number  of  profile  lines  to  process 
(card  1  only;  this  field  must  be 
completed) . 

13 

14-23 

On  card  1,  enter  distance-along- 
beac.h  values  computed  for  the  first 
line  are  valid  (see  text).  On  other 
cards,  enter  distance  between  last 
line  entered  on  previous  card  and 
first  on  this  card. 

F10.3 

24-26 

Profile  line  number1 

13 

27-36 

Distance  between  adjacent  profile 
lines 

F10.3 

37-39 

Profile  line  number 

13 

40-49 

Distance  between  adjacent  profile 
lines 

F10.3 

50-52 

Profile  line  number 

13 

53-62 

Distance  between  adjacent  profile 
lines 

F10.3 

63-65 

Profile  line  number 

13 

66-75 

Distance  between  adjacent 
profile  lines 

F10.3 

76-78 

Profile  line  number 

13 

Final  entry 

Distance-along-beach  values  com¬ 
puted  for  last  profile  line  are 
valid  (see  text). 

F10.3 

Profile  line  numbers  must  be  entered  in  physical  (geographic) 
not  numeric  order. 


NOTE. — Do  not  enter  data  for  more  profile  lines  than  Indicated 
on  card  1 . 


5.  Output  Specification  Cards. 

SURVY2  will  produce  six  tabular  and  two  graphical  displays:  TABLE2 , 
TABLE3,  TABLE4,  TABLE5 ,  PL0T4,  and  PL0T5.  These  outputs  are  described  in 
detail  in  Section  V.  Any  or  all  of  the  outputs  may  be  produced  during  a 
single  run.  An  output  and  any  required  specifications  for  the  output  are 
selected  by  entering  an  output  specification  card.  One,  and  only  one,  card 
must  be  entered  for  each  output  selected. 
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a.  Table  Output. 

(1)  TABLE2 .  Table  18  describes  the  card  format  for  selection  of 
TABLE2  (Fig.  5)  output.  This  table  Is  the  only  one  for  which  there  are 
optional  specifications.  These  specifications  include  the  printing  of 
multiple  contour  Intercepts  and  results  of  regression  analysis  for  the 
seawardmost  Intercept  of  the  zero  contour  (the  shoreline)  with  respect  to 
time.  The  type  of  time  (hours,  days,  months,  or  years)  selected  for  this 
analysis  must  agree  with  that  selected  for  any  plot  output. 


Table  18.  TABLE2 — output  specification  card. 


Position 

No. 

Entry  description 

FORTRAN 

format 

Default 

value 

1-5 

"TABLE" 

A7 

None 

9 

"2" 

11 

None 

11-14 

Enter  code  for  display  of  multiple 
intercepts: 

blank  -  no  multiple  intercepts  displayed 

"MULT"  -  multiple  intercepts  will  be 
displayed 

A4 

No  multiple 

Intercepts 

displayed 

16-25 

Enter  code  for  display  of  regression 
analysis: 

blank  -  no  regression  analysis  of 
change  in  shoreline  position 

"REGRESSION"  -  regression  for  change  in 
shoreline  position  will  be  computed  and 
displayed 

A10 

No  regression 
analysis 

27 

Enter  code  for  type  of  time  for  regression 
analysis:1 

"H"  -  time  will  be  converted  to  hours 

"D”  -  time  will  be  converted  to  days 

"M"  -  time  will  be  converted  to  months 

"Y"  -  time  will  be  converted  to  years 

A1 

Time  converted 
to  months 

*If  PL0T4  or  PL0T5  is  output,  the  type  of  time  selected  must  match  that 
chosen  for  the  independent  axis. 
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(2)  TABLE3  to  TABLE? .  These  Cables  (Figs.  6  to  10)  have  no  optional 
specifications.  The  format  of  the  output  specification  card  required  for 
their  selection  is  described  in  Table  19. 


Table  19.  TABLE3-TABLE7 — output  specification  cards. 


Position 

Entry  description 

FORTRAN 

Default 

No. 

format 

value 

1-5 

"TABLE" 

A3 

None 

9 

Enter  appropriate  table 
number  (3,  4,  5,  6,  or  7). 

11 

None 

b.  Plot  Output.  Table  20  describes  the  format  for  the  output  specifi¬ 
cation  cards  for  plot  output  (Figs.  11  and  12)  and  defines  the  defaults  which 
will  be  assigned  if  positions  13  to  80  are  not  completed.  A  separate  card 
must  be  prepared  for  each  type  of  plot  to  be  output.  Except  for  ti  type  of 
time  specification  and  the  plot  output  unit,  it  is  not  necessary  tnat  each 
type  of  plot  have  the  same  specifications  when  more  than  one  type  is  output 
during  a  single  run;  format  specifications  for  each  type  of  plot  are  read  and 
processed  separately. 

(1)  Output  Unit  for  Plot  Commands.  The  plot  commands  may  be  written 
either  to  unit  3  (normally  signaling  card  output)  or  8  (normally  signaling 
output  to  magnetic  tape).  The  user  must  ensure  that  data  written  to  these 
units  are  handled  properly  in  the  job  control  stream.  All  plot  commands  will 
be  written  to  the  unit  defined  on  the  last  plot  output  specification  card 
encountered. 


(2)  Default  Plot  Specification.  If  the  defaults  for  values  supplied 
in  positions  13  to  80  are  acceptable  and  the  selected  output  units  of  measure¬ 
ment  are  feet,  positions  13  to  80  need  not  be  completed.  However,  if  any  plot 
specifications  are  to  be  supplied  or  output  units  are  not  feet,  all  fields 
must  be  completed.  (The  unit  onto  which  plot  commands  are  to  be  written  may 
be  changed  without  affecting  other  default  specifications.) 


(3)  Shoreline  Position  Only  Plot.  The  zero  contour,  the  shoreline 
position,  is  often  of  particular  interest.  While  PL0T4  and  PL0T5  will  depict 
changes  in  shoreline  when  the  zero  contour  is  selected  for  o-.tpc.t,  there  are 
also  versions  of  these  plots  designed  to  emphasise  the  fact  that  shoreline 
position  changes  are  being  displayed.  The  zero  contour  must  be  selected  for 
output;  if  other  contours  are  selected,  they  are  ignored.  It  is  not  possible 
to  produce  the  standard  PL0T4  and  PL0T5  outputs  during  the  same  run  as  that  of 
the  shoreline  position  version.  This  version  has  no  default  specifications 
and  when  it  is  requested,  all  plot  specifications  must  be  supplied.  PL0T4 
(Fig.  11, b)  will  draw  a  dashline  at  the  zero  distance  and  only  one  profile 
line  may  be  drawn  on  a  single  axis.  PL0T5  (Fig.  12, b)  draws  no  dashline  and, 
while  several  lines  may  be  depicted  on  a  single  plot,  there  is  no  provision 
for  differentiating  lines  when  a  zero  offset  is  used. 
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Table  20.  FoL.uat  and  defaults  for  PL0T4  and  PL0T5  specification  cards. 


Position 

No. 

Entry  description 

FORTRAN 

format 

Default 

value 

Used 

PL0T4 

by 

PL0T5 

1-4 

"PLOT" 

A7 

None 

Yes 

Yes 

9 

Plot  number  (4  or  5) 

11 

None 

Yes 

Yes 

11 

Output  unit  for  plot  commands: 

3  -  cards 

8  -  magnetic  tape 

11 

3 

Yes 

Yes 

12 

0  or  blank  -  use  defaults 
(can  be  used  only  if  output 
units  are  feet) 

11 

Use 

defaults 

Yes 

Yes 

1  -  read  plot  specifications 

2  -  plot  change  in  shoreline 
position  only;  read  plot 
specifications 

13 

0  -  contour  1  displayed 

1  -  contour  1  not  displayed 

11 

0 

Yes 

Yes 

14 

0  -  contour  2  displayed 

1  -  contour  2  not  displayed 

11 

0 

Yes 

Yes 

15 

0  -  contour  3  displayed 

1  -  contour  3  not  displayed 

11 

0 

Yes 

Yes 

16 

0  -  contour  4  displayed 

1  -  contour  4  not  displayed 

11 

0 

Yes 

Yes 

17 

0  -  contour  5  displayed 

1  -  contour  5  not  displayed 

11 

0 

Yes 

Yes 

18 

0  -  contour  6  displayed 

1  -  contour  6  not  displayed 

11 

0 

Yes 

Yes 

19 

0  -  contour  7  displayed 

1  -  contour  7  not  displayed 

11 

0 

Yes 

Yes 

20 

0  -  contour  8  displayed 

1  -  contour  8  not  displayed 

11 

0 

Yes 

Yes 

21 

0  -  contour  9  displayed 

1  -  contour  9  not  displayed 

11 

0 

Yes 

Yes 

22 

0  -  contour  10  displayed 

1  -  contour  10  not  displayed 

11 

0 

Yes 

Yes 

23 

0  -  contour  11  displayed 

1  -  contour  11  not  displayed 

11 

0 

Yes 

Yes 

24 

0  -  contour  12  displayed 

1  -  contour  12  not  displayed 

11 

0 

Yes 

Yes 
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Table  20.  Format  and  defaults  for  PL0T4  and  PL0T5 
specification  cards. — Continued 


Position 

Entry  description 

FORTRAN 

Default 

Used  by 

No. 

format 

value 

PLOT-.  PL0T5 

251 

"H"  -  time  displayed  in  hours 

A1 

Time 

Yes 

Yes 

"D"  -  time  displayed  in  days 

displayed 
in  months 

"M"  -  time  displayed  in  months 
(new  plot  each  year) 

"Y“  -  time  displayed  in  years 

Horizontal  axis  (time):  When 
time  is  in  months,  26  to  42 
may  be  blank.  When  time  is 
in  years,  the  year  should  be 
expressed  as  19xx: 

26-32 

origin 

F7.2 

January 

Yes 

Yes 

33-38 

increment  (units  per  inch 
on  plot 

F6.1 

2  months 

Yes 

Yes 

39-42 

length  in  inches 

F4.1 

6.0 

Yes 

Yes 

Vertical  axis  (distance): 

43-50 

origin 

F8.2 

-450.0 

Yes 

Yes 

51-57 

increment  (units  per  inch 
on  plot) 

F7.2 

150.0 

Yes 

Yes 

58-61 

length  in  inches 

F4.1 

5.0 

Yes 

Yes 

62-63 

Lines  per  plot  (maximum  10) 

12 

1 

Yes 

(must  =  1) 

Yes 

64-69 

Offset 

F6.2 

0.0 

No 

Yes 

70-75 

Overlap: 

A6 

No 

No 

Yes 

"OVRLAP"  -  plots  will  be 
overlapped 

overlap 

blank  -  plots  will  not 
be  overlapped 

76 

Factoring: 

11 

No 

Yes 

Yes 

0  -  no  factoring 

1  -  factor  plots 

factoring 

77-80 

Plot  multiple  contour 

A4 

No 

Yes 

No 

Intercepts: 

multiples 

"MULT"  -  yes 

blank  -  no 

1This  selection  (time)  must  be  the  same  for  both  plot  types  and  agree  with 
time  selected  on  TABLE2,  if  any. 
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(4)  Horizontal  Axis.  There  are  four  ways  in  which  time  may  be 
represented  on  the  horizontal  axis:  hours,  days,  months,  or  years  (Fig.  15). 
When  time  is  represented  in  months,  the  user  has  no  control  over  the  origin, 
length,  or  increment  on  the  horizontal  axis.  Positions  26  to  42  may  be  left 
blank. 
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1 
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5 

1 

10 

1 

15  20 
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1  1 

25 

1 

30  DAYS(D) 

1 

10 

20 

30 

HOURS , 

40  50 

1 7JUN7 1 / 1000-20JUN7 1 /0800 

60 

70  HOURS(H) 

Figure  15.  Types  of  time-elapsed  axis  available. 


(5)  Lines  Per  Plot.  While  data  for  only  one  profile  line  can  be 
depicted  on  each  PL0T4  output,  data  for  up  to  10  profiles  may  be  displayed  on 
each  PL0T5  output.  The  number  of  lines  per  plot  appears  in  the  plot  title 
describing  how  many  profile  lines  are  represented  on  the  plot.  It  is  possi¬ 
ble,  therefore,  for  the  last  plot  for  a  given  contour  to  contain  data  for  less 
lines  than  indiraled  in  the  title. 

(6)  Offset  (PL0T5  Only).  When  more  than  one  profile  is  drawn  on  a 
single  plot,  the  second  and  subsequent  profiles  may  be  offset.  The  offset 
will  be  added  to  vertical  coordinates  before  additional  lines  are  plotted. 
The  offset  may  be  positive  or  negative;  no  provision  has  been  made  for  differ¬ 
entiating  lines  when  a  zero  offset  is  used.  The  profile  line  with  the  largest 
number  is  drawn  first  and  the  others  are  offset. 

(7)  Overlap  (PL0T5  Only).  A  new  axis  is  automatically  drawn  when  all 
data  collected  at  a  single  profile  line  have  been  plotted.  When  the  number  of 
profiles  drawn  on  a  single  plot  (lines  per  plot)  is  greater  than  1,  the  user 
may  specify  that  plots  be  overlapped.  The  contour  position  at  the  last  pro¬ 
file  line  drawn  on  each  plot  will  be  the  first  drawn  on  the  next  until  all 
data  for  the  contour  have  been  plotted.  The  overlapped  profile  counts  toward 
the  number  of  lines  per  plot. 

(8)  Factoring.  The  factoring  option  is  used  to  specify  whether  or 
not  the  final  plot  size  is  to  be  altered  before  being  output.  The  user  has  no 
control  over  the  factor  used;  this  is  determined  by  the  length  of  the  longer 
axis.  When  plots  are  factored,  the  x-axis  will  be  no  longer  than  5  Inches  and 
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the  y-axis  no  longer  than  6  Inches.  Plot  size  will  be  increased  if  both  axes 
are  shorter  and  decreased  if  either  is  longer. 


(9)  Defining  Axis  Length.  Increment,  and  Origin.  The  TABI.E2  output 
from  the  module  can  be  used  to  determine  the  best  axis  specifications.  Since 
PL0T4  allows  no  offsetting,  care  should  be  taken  that  the  length  and  increment 
allow  sufficient  space  between  the  lines  representing  the  various  contours. 
If  they  do  not,  the  elevations  which  label  the  lines  may  be  overwritten. 
Distance  to  more  landward  contour  positions  must  be  considered  when  multiple 
intercepts  are  to  be  plotted.  Allow  an  extra  inch  on  both  the  horizontal  and 
vertical  axes  so  that  the  plot  legend  will  not  interfere  with  the  plotted 
data.  When  a  large  number  of  plots  are  to  be  produced,  some  test  plots  should 
be  run  and  examined  before  the  final  production  run  is  submitted. 


VII.  SUMMARY 


SURVY2  produces  six  tabular  and  two  graphical  displays.  The  major  func¬ 
tion  of  the  module  is  to  show  the  distance  to  defined  contours  and  the  changes 
in  contour  positions  through  time.  Contour  positions  at  specific  profile 
lines  and  at  a  locality  are  displayed.  If  desired,  special  emphasis  may  be 
given  to  the  movement  of  the  zero  contour,  the  shoreline  position,  including 
regression  analysis  of  its  change  with  time.  The  outputs  have  been  designed 
so  that  they  can  be  used  in  reports  without  being  redrafted. 
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APPENDIX 

SURVY2  RECORD  LAYOUTS  FOR  OPTION,  PROCESSING, 
AND  OUTPUT  SPECIFICATION  CARDS 
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Program  ID  Card 


Option  Card 


A 


Option  Card  2 
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Option  Card  3 


Option  Card  4,  Format  1 
(must  not  be  followed  by  SUP  4A  cards) 


Option  Card  4,  Format  2 
(must  be  followed  by  SUP  4A  cards) 


■0  COLUMN  MY  PUNCH  TRANSCRIPT  LAYOUT  SHEET  Mil  o>  mint 


SUP  4A  cards 

(must  be  preceded  by  option  card  4,  Format  2) 
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Option  Card 
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